home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds / migcmd.man < prev    next >
Text File  |  1990-02-16  |  5KB  |  110 lines
  1. ' $Header: /sprite/src/cmds/migcmd/RCS/migcmd.man,v 1.5 90/02/16 11:08:38 douglis Exp $ SPRITE (Berkeley)
  2. .so \*(]ltmac.sprite
  3. .HS MIGCMD cmds
  4. .BS
  5. .SH NAME
  6. migcmd \- Print or update information relating to process migration
  7. .SH SYNOPSIS
  8. \fBmigcmd\fR [\fB\-sSZptT\fR] [\fB\-[IE] (none|all|root)\fR] [\fB\-[il] (0|1)\fR] [\fB\-l (0|1)\fR] [\fB\-P \fInumRecs\fR] [\fB\-d \fIdebugLevel\fR] [\fB\-V \fImigrationVersion\fR] 
  9. .SH OPTIONS
  10. .IP "\fB\-s\fR" 20
  11. A message is printed to indicate the status of process migration on the 
  12. current host, including the migration level and the conditions under
  13. which migration is permitted.
  14. .IP "\fB\-S\fR" 20
  15. Migration statistics are printed.  These include such values as the
  16. average time to migrate an active process, the average time to perform
  17. a remote exec, and the total number of migrations, evictions, and
  18. remote execs performed.
  19. .IP "\fB\-Z\fR" 20
  20. The kernel migrations statistics are reset to 0.
  21. .IP "\fB\-I\fR" 20
  22. Change the import restrictions for process migration.  (The caller must be root.)
  23. .IP "\fB\-E\fR" 20
  24. Change the export restrictions for process migration.  (The caller must be root.)
  25. .IP "\fB\-i\fR" 20
  26. Change whether idle time is considered when determining the availability of 
  27. this host.  (The caller must be root.)
  28. .IP "\fB\-l\fR" 20
  29. Change whether load average is considered when determining the availability of 
  30. this host.  (The caller must be root.)
  31. .IP "\fB\-p\fR" 20
  32. Process migration trace records are printed.  The number of records
  33. may be altered by the \fB\-P\fR option.
  34. .IP "\fB\-P \fInumRecs\fR" 20
  35. The number of trace records to print is modified to be \fInumRecs\fR.  This
  36. option must be used with the \fB\-p\fR option.
  37. .IP "\fB\-t\fR" 20
  38. Process migration tracing is enabled for the current host.
  39. .IP "\fB\-T\fR" 20
  40. Process migration tracing is disabled for the current host.
  41. .IP "\fB\-d \fIdebugLevel\fR" 20
  42. The kernel process migration debug level is set to \fIdebugLevel\fR.
  43. .IP "\fB\-V \fImigrationVersion\fR" 20
  44. The kernel process migration version is set to \fImigrationVersion\fR.
  45. The caller must be root.
  46. .BE
  47. .SH INTRODUCTION
  48. .LP
  49. This command is used to perform functions related to process migration.
  50. \fBMigcmd\fR  is normally used to print the status of process migration 
  51. availability or migration statistics.  \fBMigcmd\fR may also be used
  52. to restrict which users may export or import processes from or to 
  53. the local host (the caller must be root to do so); change whether load
  54. average and/or idle time are considered when deciding whether the
  55. current host is available for imports;
  56. print process
  57. migration trace  records; enable or disable tracing of process
  58. migration activity; or set the kernel's migration ``debugging level''
  59. or ``migration version''.
  60. .SH "MIGRATION STATE"
  61. .LP
  62. \fBMigcmd\fR prints the status of process migration
  63. availability if the \fB\-s\fR flag is specified.
  64. As root, one may modify the restrictions on process migration.  For
  65. both exporting and importing processes, root may choose to restrict
  66. migration to processes owned by root, or not allow migration at all,
  67. or allow all users to migrate.  These options are specified to the
  68. \fB\-E\fR and \fB\-I\fR flags as \fBroot\fR, \fBnone\fR, and \fBall\fR
  69. respectively.  In addition, root is permitted to instruct the
  70. \fBloadavg\fR daemon whether to consider idle time and/or load average
  71. when announcing the availability of the host for importation.  These
  72. options are \fB\-i\fR and \fB\-l\fR, respectively, and take an integer
  73. argument: \fB1\fR specifies that the criterion should be ignored, and
  74. \fB0\fR specifies that it should be considered.
  75. .SH "STATISTICS"
  76. .LP
  77. The \fB-S\fR flag causes \fBMigcmd\fR  to print statistics on its
  78. standard output.  These statistics change too rapidly to list the
  79. format here.  The format is (hopefully) self-explanatory.
  80. .SH "TRACING"
  81. .LP
  82. The \fB\-p\fR flag may be used to dump process migration trace records.
  83. The maximum number of records defaults to 200 but may be modified with
  84. the \fB\-P\fR option.  By default, tracing is disabled and no trace
  85. records will be printed.  To enable tracing, one may specify the
  86. \fB\-t\fR flag, and to disable it, one may specify the \fB\-T\fR flag.  
  87. .SH "MIGRATION DEBUG LEVEL"
  88. .LP
  89. The kernel's debug level may be modified using the \fB\-d\fR  option.
  90. Subsequently higher values for the debug level will cause more
  91. debugging statements 
  92. to be executed. For example, to have no migration debugging enabled
  93. whatsoever, the level may be set to 0.  To enable error messages that
  94. indicate unusual but non-fatal events, the level may be 2 (this is the
  95. current default).  To enable more messages about the internal
  96. operation of migration within the kernel, such as forwarded system
  97. calls, the level may be set to values from 3-10.  ``Less interesting''
  98. events are conditioned on higher values of the debug level.
  99. .SH "MIGRATION VERSION"
  100. .LP
  101. The kernel's migration version may be modified by root using the
  102. \fB\-V\fR  option.  This should be done only when the kernel is
  103. compiled with an incorrect version for some reason, in order to cause
  104. the kernel to be compatible vis-a-vis migration with a different class
  105. of kernels.
  106. .SH "SEE ALSO"
  107. mig
  108. .SH KEYWORDS
  109. debug level, eviction, process migration, remote execution 
  110.